home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / flaka101.zip / FLAK.HLP < prev    next >
Text File  |  1992-10-04  |  101KB  |  2,462 lines
  1. %@tit FLAK 1.01 - File List & Access by Keyboard
  2. %@toc 0003966 Title
  3. %@toc 0004665 Technical Support
  4. %@toc 0005357 Introduction
  5. %@toc 0006092 Copyright Notice
  6. %@toc 0006802 DISCLAIMER NOTICE
  7. %@toc 0007671 Shareware License/Registration/Distribution Notice
  8. %@toc 0011400 Registration Form
  9. %@toc 0013342 Description
  10. %@toc 0014804 Requirements
  11. %@toc 0015346 Installation & Setup
  12. %@toc 0015963 Documentation Syntax Conventions and Notations
  13. %@toc 0018234 Display Screen
  14. %@toc 0021921 Startup: General
  15. %@toc 0022461 Startup: [listi]
  16. %@toc 0026540 Startup: [options]
  17. %@toc 0032852 Startup: Configuration File - General
  18. %@toc 0033128 Startup: Configuration File - Parameter Record
  19. %@toc 0033673 Startup: Configuration File - Function Key Record
  20. %@toc 0034748 Startup: Configuration File - Extension Record
  21. %@toc 0035969 Startup: Configuration File - Alias Record
  22. %@toc 0036871 Keys: Brief Description (Also available via F1)
  23. %@toc 0038172 Keys: ENTER      (execute command areas)
  24. %@toc 0038295 Keys: CTL-ENTER  (display command areas)
  25. %@toc 0038693 Keys: ESC        (clear commands, exit)
  26. %@toc 0039133 Keys: F1         (HelpPrompt)
  27. %@toc 0039869 Keys: F2         (HelpBar, HelpFile)
  28. %@toc 0040227 Keys: Others     (Detailed Descriptions)
  29. %@toc 0042133 Command Area: General
  30. %@toc 0042877 Command Area: Automatic Fileid Appending
  31. %@toc 0043716 Command Area: Automatic Fileid Appending Cancellation
  32. %@toc 0044158 Command Area: Automatic Directory Navigation
  33. %@toc 0044750 Command Area: :EXT (Extension) Processing
  34. %@toc 0045615 Command Area: :ALIAS (Alias) Processing
  35. %@toc 0046544 Command Area: Substitution Strings and Flags
  36. %@toc 0049426 Command Area: Application/Command Execution ('Launching')
  37. %@toc 0050723 Command Area: CD (Change Directory)
  38. %@toc 0051250 Command Area: D: (Drive)
  39. %@toc 0051777 Command Area: RENAME (Move)
  40. %@toc 0052562 Command Area: ERASE/DELETE **WARNING**
  41. %@toc 0054157 FLAK Command: General
  42. %@toc 0054767 FLAK Command: =            (Repeat Previous Command)
  43. %@toc 0055642 FLAK Command: ?            (Reset Previous Command)
  44. %@toc 0057594 FLAK Command: /            (Make first line in display)
  45. %@toc 0059870 FLAK Command: /A           (Search specific file Attributes)
  46. %@toc 0060844 FLAK Command: /B           (Bell is audible or not)
  47. %@toc 0061628 FLAK Command: /CD          (Change Drive/Directory)
  48. %@toc 0063250 FLAK Command: /CL          (Change Drive/Directory and List)
  49. %@toc 0066647 FLAK Command: /D           (Display 'nn' or maximum fileids)
  50. %@toc 0067437 FLAK Command: /DI          (Display <fileid> or specified file)
  51. %@toc 0068380 FLAK Command: /E           (Execute .BAT, .COM, .EXE files)
  52. %@toc 0069169 FLAK Command: /F           (Find fileid with(out) chars)
  53. %@toc 0071854 FLAK Command: /G           (Get Project disk file data)
  54. %@toc 0073047 FLAK Command: /H           (HelpBar visible or not)
  55. %@toc 0073784 FLAK Command: /K           (Display/reset Function Keys)
  56. %@toc 0074303 FLAK Command: /L           (Reset [listi] data and list)
  57. %@toc 0077178 FLAK Command: /L+          (Append [listi] data and list)
  58. %@toc 0079285 FLAK Command: /M           (Mark/Move fileids in the list)
  59. %@toc 0081645 FLAK Command: /O           (Order files by field value)
  60. %@toc 0083166 FLAK Command: /P           (Put fileid|[listi] to disk file)
  61. %@toc 0084881 FLAK Command: /R           (Refresh display after DOS)
  62. %@toc 0085801 FLAK Command: /S           (Maximum RAM Storage required)
  63. %@toc 0086710 FLAK Command: /T           (Search Tree for all occurrences)
  64. %@toc 0088071 FLAK Command: /V           (Set Video characteristics)
  65. %@toc 0088865 FLAK Command: /XI          (Exit FLAK)
  66. %@toc 0089776 FLAK Command: /Y           (Set Substitution Symbol)
  67. %@toc 0090804 Project Files
  68. %@toc 0093753 Resource Utilization & Optimization
  69. %@toc 0095754 Network Execution
  70. %@toc 0096085 Windows Installation
  71. %@toc 0096880 Hints
  72. %@toc 0099136 Version History
  73. %@toc 0099538 HELP Utilization
  74. %@sec Title
  75. %@ign variable text = FLAKA101 1.01 170KB 10/04/92
  76. %@ign condxtrc: bbs = Bulletin Board Service distribution
  77. %@ign condxtrc: dsk = Disk                   distribution
  78. %@ign file: flakread.me2 start
  79.  
  80.  
  81.  
  82.                                  FLAK
  83.  
  84.                      File List & Access by Keyboard
  85.  
  86.  
  87.                               Version 1.01
  88.  
  89.                                  (BBS)
  90.  
  91.                                 10/04/92
  92.  
  93.           Copyright 1992 Paul J. Dickler, all rights reserved:
  94.  
  95. Users,  sysops,  and  vendors  are  responsible  for compliance with the
  96. Copyright, DISCLAIMER,  and Shareware  License/Registration/Distribution
  97. notices in this document.
  98. %@ign
  99. %@sec Technical Support
  100. Technical support for installation is via the command:
  101.  
  102.          FLAKINST
  103.  
  104. which offers Authenticity Verification information, demonstration
  105. displays (tutorial), video color/attribute selection, registration,
  106. production promotion, and more.
  107.  
  108.  
  109. Technical support for 'Requests For Modification' and 'Problem Reports'
  110. is available to registered users via:
  111.  
  112. Compuserv:  71763,3277
  113.  
  114. Mail:       Paul J. Dickler
  115.             P.O. Box 732
  116.             Denville, NJ 07834
  117.  
  118.  
  119. When requesting such support, be sure to specify the FLAK version you
  120. are executing, your system configuration, and where you obtained your
  121. copy of FLAK (BBS, vendor, etc.).
  122. %@ign
  123. %@sec Introduction
  124. FLAK is a full-screen file listing program which provides a convenient
  125. method of accessing and manipulating files from multiple drives and/or
  126. directories simultaneously.  It is intended for PC users executing DOS
  127. commands, batch files, user programs, and utilities, and creates a very
  128. productive working environment.
  129.  
  130. FLAK commands allow sorting, appending, rebuilding, saving, and
  131. restoring the interactive onscreen file list, and more.  A Configuration
  132. File allows the user to specify command abbreviations and aliases,
  133. default commands for specific file extensions, and function-key
  134. definitions for frequently-issued commands.
  135.  
  136. Requires: DOS 3.00, 170KB, hard disk.  Registration: US $25/35.
  137. %@ign
  138. %@sec Copyright Notice
  139. "FLAK" (the FLAK program, support programs and files - the "Software")
  140. is copyrighted material, and remains the property of the author.
  141.  
  142. All users are automatically granted a limited license to distribute and
  143. evaluate the Software in accordance with the terms and conditions in the
  144. "DISCLAIMER NOTICE" and "Shareware License/Registration/Distribution
  145. Notice", which follow.
  146.  
  147. ┌──────────────────────────────────────────────────────────────────────┐
  148. │ Continued use of the Software requires registration and payment,  as │
  149. │ described below.                                                     │
  150. └──────────────────────────────────────────────────────────────────────┘
  151. %@ign
  152. %@sec DISCLAIMER NOTICE
  153. "FLAK" IS LICENSED ON AN "AS IS" BASIS, WITH NO WARRANTIES, EITHER
  154. EXPRESS OR IMPLIED, WITH RESPECT TO ITS MERCHANTABILITY OR FITNESS FOR
  155. ANY PARTICULAR PURPOSE.
  156.  
  157. ALTHOUGH GREAT EFFORT HAS GONE INTO THE DESIGN, CREATION, AND TESTING OF
  158. THE SOFTWARE, THE VARIABILITY OF COMPUTING ENVIRONMENTS INTO WHICH IT
  159. MAY BE LOADED AND EXECUTED REQUIRES THAT THE USER ACCEPT THE ENTIRE RISK
  160. OF ANY AND ALL DAMAGES WHICH MAY BE SUFFERED.
  161.  
  162. ANY LIABILITY OF THE AUTHOR IS LIMITED EXCLUSIVELY TO PRODUCT
  163. REPLACEMENT OR REFUND OF REGISTRATION FEE.
  164.  
  165. THESE TERMS AND CONDITIONS WILL BE CONSTRUED AND ENFORCED IN ACCORDANCE
  166. WITH THE LAWS OF THE STATE OF NEW JERSEY, COUNTY OF MORRIS, USA, AS
  167. APPLIED TO CONTRACTS ENTERED INTO AND PERFORMED WITHIN THAT
  168. JURISDICTION.
  169.  
  170. SEE "SHAREWARE LICENSE/REGISTRATION/DISTRIBUTION NOTICE" WHICH FOLLOWS.
  171. %@ign
  172. %@sec Shareware License/Registration/Distribution Notice
  173. FLAK is distributed as "shareware".
  174.  
  175. That is, the author, while retaining all rights, makes the Software
  176. freely available to users, sysops (system operators), and vendors for
  177. distributing, testing, and using under the following terms and
  178. conditions:
  179.  
  180.  
  181. License
  182. ────────────────────────────────────────────────────────────────────────
  183. FLAK is licensed in 2 phases:
  184.  
  185.  1. Testing
  186.     License is automatically granted to all users to test FLAK for a
  187.     reasonable period of time.
  188.  
  189.  2. Using
  190.     If, after the above test period, the user decides to use FLAK on a
  191.     continuing basis, the user must 'register' such usage as follows:
  192.  
  193.     (See 'Registration Form' below for associated fees.)
  194.  
  195. Registration
  196. ────────────────────────────────────────────────────────────────────────
  197. User Type:
  198. ──────────
  199.  
  200.     Single User
  201.     ───────────
  202.     For each possible simultaneous individual user, 1 registration is
  203.     required.  A single user may place a copy of the Software on any
  204.     number of computers, as long as only 1 copy is being executed at any
  205.     given time.  However, multiple executions by a single user in a
  206.     multi-tasking environment (i.e., multiple windows) are considered an
  207.     individual use.
  208.  
  209.     Multiple User
  210.     ─────────────
  211.     For each possible simultaneous individual user, 1 registration is
  212.     required.  Multiple users executing a single copy of FLAK in a
  213.     network environment require multiple registrations.  However,
  214.     multiple executions by each user in a multi-tasking environment are
  215.     considered an individual use.
  216.  
  217. Version Type:
  218. ─────────────
  219.  
  220.     In-use Version
  221.     ──────────────
  222.     Upon registration, user receives instructions on removing the
  223.     Shareware 'reminder' prompt from the FLAK program already in use.
  224.  
  225.     Upgrade Version
  226.     ───────────────
  227.     Upon registration, user receives instructions on removing the
  228.     Shareware 'reminder' prompt from the FLAK program already in use.
  229.     Also, when available, user receives the next upgrade version of FLAK
  230.     and instructions for removing its reminder prompt.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239. Distribution:
  240. ───────────────────────────────────────────────────────────────────────
  241. FLAK may ONLY be distributed by transmitting or copying the file:
  242.  
  243.     FLAKA101.ZIP
  244.  
  245. a compressed, virus-proof, Archive (requires PKUNZIP (PKWARE, Inc)).
  246.  
  247. Modification of the above, or distribution of any expanded FLAKA101
  248. Archive files is STRICTLY FORBIDDEN, except as follows:
  249.  
  250. ┌──────────────────────────────────────────────────────────────────────┐
  251. │ Sysops and vendors may add files to the FLAKA101 Archive via the     │
  252. │ PKZIP (PKWARE, Inc) program.  However, the ORIGINAL FLAKA101 Archive │
  253. │ MUST BE PRESERVED, because it contains Authenticity Verification     │
  254. │ data, which is cited in the Installation and Setup procedures.       │
  255. └──────────────────────────────────────────────────────────────────────┘
  256.  
  257. Note:
  258. Since the FLAKA101 Archive contains data encryption technology, it may
  259. not be exported outside the United States or Canada.  Please contact the
  260. author if an export version of the Software is required.
  261.  
  262. Additionally:
  263.  
  264.     Users
  265.     ─────
  266.     Users are encouraged to distribute FLAK to friends and other users,
  267.     as above.
  268.  
  269.     Sysops
  270.     ──────
  271.     Sysops may charge at most the standard rate for the Sysops' services
  272.     for connect time, file transmission, file copying, etc., for the
  273.     above.
  274.  
  275.     Vendors
  276.     ───────
  277.     Vendors may charge at most US $5 for the above.
  278.     Additionally, vendors must notify the author, in writing, of any
  279.     distribution mechanism in use.
  280.  
  281. %@ign
  282. %@sec Registration Form
  283. %@ign file: flakreg.frm start
  284. FLAK 1.01 (BBS) - File List & Access by Keyboard - Registration Form
  285.  
  286.                                               Date:  ___________________
  287.  
  288. Send (and make check/money order payable) to:
  289.  
  290.                             Paul J. Dickler
  291.                               P.O. Box 732
  292.                           Denville, NJ  07834
  293.  
  294. From:
  295.          Name:      __________________________________
  296.  
  297.          (Company:) __________________________________
  298.  
  299.          Street:    __________________________________
  300.  
  301.                     __________________________________
  302.  
  303.          City:      __________________________________
  304.  
  305.          State/Zip: __________________________________
  306.  
  307.  
  308. In-use Version:
  309. ---------------
  310.     Version Number:     _________________________
  311.  
  312.     Vendor/Distributor: _________________________
  313.  
  314.     Single   user             US $25
  315.      2 - 10  users            US $23 each  Count: ______
  316.     11 - 20  users            US $21 each
  317.     21 & up  users            US $19 each      Sub total:  _____________
  318.  
  319.  
  320. Upgrade Version:
  321. ----------------
  322.     Single   user             US $35
  323.      2 - 10  users            US $33 each  Count: ______
  324.     11 - 20  users            US $31 each
  325.     21 & up  users            US $29 each      Sub total:  _____________
  326.  
  327.     Diskette format (circle/check one):
  328.  
  329.          5.25" ______      3.5" ______
  330.  
  331.     Distribution is by single diskette -   Count: ______
  332.     Extra copies:             US $5  each      Sub total:  _____________
  333.  
  334.     Distribution outside of United States
  335.     and Canada:               US $5            Sub total:  _____________
  336.  
  337.     New Jersey residents -
  338.     Add state tax:             %6.0            Sub total:  _____________
  339.  
  340.  
  341.                                     Enclosed Grand total:  _____________
  342. %@ign file: flakread.me2 stop
  343. %@ign file: flakreg.frm stop
  344. %@ign
  345. %@sec Description
  346. FLAK is a full-screen file listing program which provides a convenient
  347. method of accessing and manipulating files from multiple drives and/or
  348. directories simultaneously.  It is intended for PC users executing DOS
  349. commands, batch files, user programs, and utilities, and creates a very
  350. productive working environment.
  351.  
  352. A list of files from any combination of drives and directories is
  353. created and displayed.  DOS commands may then be entered on the screen
  354. which automatically include all (or specified) parts of the displayed
  355. fileids (a file's drive, path, file-name, file-extension) as required,
  356. or desired.
  357.  
  358. Batch files and applications may be 'launched' in the same manner.
  359.  
  360. 'Project Files' containing file/path information may be created and
  361. subsequently read to display specific collections of files.
  362.  
  363. FLAK Commands may also be entered to sort, rebuild, append, modify, and
  364. manipulate the onscreen file list and display, and cause special actions
  365. during DOS command processing.
  366.  
  367. As further aids to productive file manipulation, Configuration Files may
  368. be utilized which can contain:
  369.  
  370.     * abbreviations and aliases for commands
  371.     * default commands for specific file extensions
  372.     * function-key definitions for frequently-issued commands
  373.  
  374. Different Configuration Files may be utilized for various combinations
  375. of the above, allowing highly customized working environments for
  376. different projects.
  377. %@ign
  378. %@sec Requirements
  379. FLAK executes on any IBM PC or compatible running DOS 3.xx or higher.
  380.  
  381. FLAK utilizes approximately 170KB (kilobytes) of RAM, providing a
  382. minimum file list of 200 entries.  Approximately 25 more bytes are
  383. obtained for each additional entry above the 200, up to the current
  384. implementation limit of 2,000.
  385.  
  386. A hard disk is strongly recommended because FLAK can be instructed to
  387. 'swap' itself from RAM to disk during DOS command execution to maximize
  388. available RAM.  See 'Resource Utilization & Optimization'.
  389. %@ign
  390. %@sec Installation & Setup
  391. %@ign file: flakread.me start
  392. FLAK 1.01 (BBS) Installation and Setup (hard disk):
  393. 1. Create a new directory ('c' drive assumed here).  Enter:
  394.          C:
  395.          MKDIR \FLAK
  396.  
  397. 2. Make the new directory current. Enter:
  398.          CD \FLAK
  399.  
  400. 3. Download/copy the 'FLAKA101.ZIP' Archive from your Bulletin
  401.    Board Service (BBS) into the new directory.
  402.  
  403. 4. Expand the Archive.  Enter:
  404.          PKUNZIP FLAKA101
  405.  
  406.    Important: Note all "-AV", warning, and final messages.
  407.  
  408. 5. Continue FLAK Installation and Setup.  Enter:
  409.          FLAKINST
  410. %@ign file: flakread.me stop
  411. %@ign
  412. %@sec Documentation Syntax Conventions and Notations
  413. Syntax Conventions:
  414. ───────────────────
  415. Upper-case is generally used to indicate characters or commands which
  416. are to be entered as they appear, although when actually entered,
  417. lower-case may be utilized.
  418.  
  419. Lower-case is generally used to indicate characters or commands which
  420. are to be replaced by a user-specified parameter.
  421.  
  422. A REQUIRED parameter, or choice of required parameters, is indicated by
  423. enclosing it within vertical bars.  That is, the following indicate that
  424. 'name0', and EITHER 'parm1' OR 'parm2' MUST be specified.  The vertical
  425. bars, however, are not coded:
  426.  
  427.     |NAME0|        |PARM1|PARM2|        |PARM1|
  428.                                         |PARM2|
  429.  
  430.  
  431. An OPTIONAL parameter, or a choice of optional parameters, is indicated
  432. by enclosing them within brackets, separated by a vertical bar, or
  433. enclosed within vertical bars.  That is, the following indicate that
  434. EITHER 'name0', 'name1', 'name2', OR NOTHING may be specified.  The
  435. brackets and bars are not coded:
  436.  
  437.     [name0]        [name1|name2]       [|name1|]
  438.                                         |name2|
  439.  
  440.  
  441. If a parameter may be REPEATED, it will be followed by elipses:
  442.  
  443.     [...]
  444.  
  445.  
  446. Notations:
  447. ─────────-
  448. The following notation:
  449.  
  450.     [pathi]
  451.  
  452.     is used to indicate a path specification consisting of all or some
  453.     of the following:
  454.  
  455.          [d:][\path\][fileid]
  456.  
  457.     where:
  458.  
  459.          [d:]
  460.               Is a drive letter (A-Z), followed by a colon, as shown.
  461.  
  462.          [\path\]
  463.               Is a complete path specification to a sub-directory, with
  464.               the backslashes as shown.
  465.  
  466.          [fileid]
  467.               Is a fileid specification which may contain the '?' and
  468.               '*' characters (as in the DOS DIR command) to represent a
  469.               single character or any number of characters,
  470.               respectively.
  471.  
  472.  
  473. The following notation:
  474.  
  475.     [listi]
  476.  
  477.     is a list of one or more drives, paths, fileids, 'special' file
  478.     descriptors, or file attribute specifications, and is discussed
  479.     fully in following sections.
  480.  
  481.  
  482. The following notation:
  483.  
  484.     <ENTER>
  485.     <ESC>
  486.     etc...
  487.  
  488.     indicates that the named key is pressed.
  489. %@ign
  490. %@sec Display Screen
  491. FLAK displays the following screen:
  492. ┌─────────────────────────────────────────────────────────────────────┐
  493. │ FLAK v/as <<<<<<<<< current drive/directory >>>>>>>>> calendar/clock│
  494. │  fs/fmax  <<<<<<<<  [listi] specification  >>>>>>>>> (error message)│
  495. │ <fileid>     <size>  <date>  <time>  <path>                         │
  496. │ <fileid>     <size>  <date>  <time>  <path>                         │
  497. │ <fileid>     <DIR>   ------  ------  <path>                         │
  498. │ ...etc...                                                           │
  499. │ ~~ bytes~~  nnnnnn   ------  ------  <path>                         │
  500. │ ...etc...                                                           │
  501. │(<<<<<<<<<<<<<<<<<<<<<<<<<< HelpBar >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>)│
  502. └─────────────────────────────────────────────────────────────────────┘
  503.  
  504. Where:
  505.     Field                                               Video
  506.          Description                                    Characteristics
  507.     --------------------------------------------------------------------
  508.     FLAK                                                        (Normal)
  509.          Indicates the FLAK program.
  510.  
  511.     |v/  |                                                      (Normal)
  512.     | /as|                                                     (Intense)
  513.          Indicates the program Version number.
  514.  
  515.          Or, if the '/A...'  Attribute Specification has been issued,
  516.          this field will indicate the file attributes currently included
  517.          in any subsequent search, with the following characters:
  518.  
  519.               D - Directory files.
  520.               S - System files.
  521.               H - Hidden files.
  522.               A - Archive flag set.
  523.               R - Ready/only flag set.
  524.  
  525.     current drive/directory                                    (Hilight)
  526.          Is the DOS Current Drive and Current Directory.
  527.  
  528.     calendar/clock                                              (Normal)
  529.          Shows the current day, date, and time.
  530.          The clock is updated only when the display is refreshed, not
  531.          dynamically.
  532.  
  533.     fs/fmax                                                    (Intense)
  534.          Shows the number (within the file list) of the first entry on
  535.          the screen, followed by the total number of entries in the
  536.          list.
  537.  
  538.     [listi] specification                                      (Intense)
  539.          Is the list information specification which created the file
  540.          list.
  541.  
  542.     error message                                              (Intense)
  543.          If present, indicates what error occurred.
  544.  
  545.     |<fileid>| |<size>| <date>  <time>  <path>                  (Normal)
  546.                |<attr>|                                        (Intense)
  547.          Indicate the fileid, size (in bytes), date and time of last
  548.          modification, and path information for each file in the list.
  549.  
  550.          <fileid> is Intense when Automatic Fileid Appending is in
  551.          effect.
  552.  
  553.          <size> field is replaced by <DIR> for parent- and sub-
  554.          directories.
  555.  
  556.          <size> field is replaced by <attr> '/A...' file Attribute
  557.          characters when F3 key is pressed.
  558.  
  559.      ~~ bytes~~  nnnnnn   ------  ------  <path>                (Normal)
  560.          Indicates the total byte count for all files satisfying the
  561.          last [listi] search in the <path> directory.
  562.  
  563.     (<< HelpBar >>)                                          (Highlight)
  564.          If turned on (by the <F2> key or '/HY' command), the last
  565.          display line will show the labels for each defined Function
  566.          Key.
  567. %@ign
  568. %@sec Startup: General
  569. FLAK is started by the command:
  570.  
  571.     FLAK  [listi]  [options]
  572.  
  573. where:
  574.  
  575.     [listi]
  576.     [options]
  577.  
  578. are described in the following sections.
  579.  
  580. If no [listi] is specified, all files in the Current Directory are
  581. listed.
  582.  
  583. If no [options] are specified, the default Configuration File
  584. 'FLAK.CFG' is read for pre-coded [listi], [options], Function Key
  585. definitions, command aliases, and abbreviations, and file-extension
  586. default actions.  See 'Startup: Configuration File' section for full
  587. details.
  588. %@ign
  589. %@sec Startup: [listi]
  590. [listi] is a list of one or more drives, paths, fileids (possibly
  591. containing 'wild' characters), 'special' file descriptors, or file
  592. attribute specifications, separated by semicolons, as follows (note that
  593. no blanks are allowed):
  594.  
  595.     |[pathi]   |  [;[pathi]]  [;[/A[x...]]]  [;[/G[fileid]]]
  596.     |T'[pathi] |                             [;[/G@[fileid]]]
  597.     |D'[pathi] |
  598.     |A'[fileid]|
  599.     |P'[fileid]|
  600.  
  601. where:
  602.  
  603. [pathi]
  604.     Causes the files in the specified drive and path to be listed.
  605.     If [d:] is not specified, the Current Drive is searched.
  606.     If [\path\] is not specified, the Current Directory is searched.
  607.     If [fileid] is not specified, all files are listed.
  608.     [fileid] may contain the '?' and '*' characters as in the DOS DIR
  609.     command to represent a single character, and any number of
  610.     characters, respectively.
  611.  
  612.     Example:  c:\dir1\*.wrk;a:
  613.  
  614.               Lists all .WRK files in the c: drive DIR1 directory and
  615.               all files in the a: drive root (\) directory.
  616.  
  617. T'[pathi]
  618.     Causes all directories in the directory TREE to be searched.
  619.     That is, all files in the specified (or defaulted) drive and
  620.     directory, and all sub-directories are searched.
  621.     If [d:] is not specified, the Current Drive is used.
  622.     If [\path\] is not specified, the root (\) is used, thus causing a
  623.     search of all directories on the drive.
  624.     [fileid] (with wild characters) may be specified to filter the list.
  625.  
  626.     Example:  t'*.bak
  627.  
  628.               Lists all .BAK files on the Current Drive.
  629.  
  630. D'[pathi]
  631.     Causes a search for sub-Directories only, as with T', above.
  632.     That is, all sub-directories in the specified drive and directory,
  633.     and all sub-directories are listed.
  634.     If [d:] is not specified, the Current Drive is used.
  635.     If [\path\] is not specified, the root (\) is used, thus causing a
  636.     search of all directories on the drive.
  637.     [fileid] may NOT be specified, as only sub-Directories are listed.
  638.  
  639.     Example:  d'\test\
  640.  
  641.               Lists all directories in the \TEST directory, and all
  642.               subdirectories.
  643.  
  644. A'[fileid]
  645.     Causes the Current Directory and each directory in the APPEND
  646.     specification list, if active, to be searched.
  647.     [fileid] (with wild characters) may be specified to filter the list.
  648.  
  649.     Example:  a'*.exe
  650.  
  651.               Lists all .EXE files in the APPEND directories.
  652.  
  653. P'[fileid]
  654.     Causes the Current Directory and each directory in the PATH
  655.     specification list, if active, to be searched.
  656.     [fileid] (with wild characters) may be specified to filter the list.
  657.  
  658.     Example:  p'*.bat
  659.  
  660.               Lists all .BAT files in the PATH directories.
  661.  
  662. /A|N|x[x..]|
  663.     Specifies the file Attributes for subsequent file searches, where
  664.     'x' is as follows:
  665.  
  666.          N - Normal (all files and directory entries)
  667.          D - Directories
  668.          S - System
  669.          H - Hidden
  670.          A - Archive flag set on
  671.          R - Read/only
  672.  
  673.     Except for 'N', attributes are exclusive, and additive.
  674.     For example:
  675.  
  676.          '/AA'  lists only files with the Archive flag set.
  677.  
  678.          '/AAR' lists files with the Archive OR Read/only flags set.
  679.  
  680.     This operand takes effect immediately, and must be reset manually.
  681.     Thus, the following:
  682.  
  683.          flak \work\;/aa;\prod\
  684.  
  685.     would list all the files in the \WORK directory, but only files with
  686.     the Archive flag in the \PROD directory.
  687.  
  688.     Subsequent lists will only include files with the Archive flag on,
  689.     until '/AN' (or another Attribute) is specified.
  690.  
  691.  
  692. /G[fileid]
  693.     Causes FLAK to Get file/path records from the [fileid] disk file,
  694.     and list them.
  695.     If [fileid] is not specified, 'WRK.FLK' is used.
  696.  
  697.     See 'Project Files' for full details.
  698.  
  699.  
  700. /G@[fileid]
  701.     Causes FLAK to Get the [listi] specification from the [fileid] disk
  702.     file, and list the files described.
  703.     If [fileid] is not specified, 'WRK.FLK' is used.
  704.  
  705.     See 'Project Files' for full details.
  706. %@ign
  707. %@sec Startup: [options]
  708. FLAK [options] available are as follows:
  709.  
  710. /B|Y|N|
  711.     Specifies whether the console bell is to be sounded for warnings.
  712.     The bell is always sounded for severe errors.
  713.     If not specified, the default is 'Y'.
  714.  
  715.  
  716. /C[fileid]
  717.     Specifies the Configuration File to be read during initialization.
  718.     If not specified, defaults to 'FLAK.CFG', which must reside in the
  719.     current directory or any PATH specification directory.
  720.     If no Configuration File is desired, specify '/CNUL'.
  721.  
  722.     See 'Startup: Configuration File' for full details.
  723.  
  724.  
  725. /D|nn|*|
  726.     Specifies the number of fileids to display on the physical screen.
  727.     Cannot exceed the number of lines in the physical screen.
  728.     '/D*' causes all the lines in the physical screen to be utilized.
  729.     If not specified, all lines in the physical screen are utilized.
  730.  
  731.  
  732. /E|Y|N|
  733.     Specifies how Executables (.BAT, .COM, and .EXE files) are to be
  734.     handled:
  735.  
  736.          Y - A leading blank Command Area causes Execution.
  737.              That is, the Executable <fileid> is pre-pended to any
  738.              Command Area input and passed to DOS.
  739.  
  740.          N - An all-blank Command Area causes use of the Configuration
  741.              File :EXT definition, if coded, for the above file types.
  742.  
  743.              See 'Startup: Configuration File' for details.
  744.  
  745.     If not specified, the default is 'N'.
  746.  
  747.  
  748. /H|Y|N|
  749.     Specifies whether the HelpBar is visible or not.
  750.  
  751.          Y - HelpBar is visible.
  752.  
  753.          N - HelpBar is not visible.
  754.  
  755.     If not specified, the default is 'N'.
  756.     The HelpBar is also made visible by the first <F2> keypress.
  757.  
  758.  
  759. /O[x[ss,ee]]
  760.     Specifies the file list sort Order, where 'x' is as follows:
  761.  
  762.          A = Attributes, name, type.
  763.          N = Name, type, path.
  764.          E = Extension,  name, path-order.
  765.          T = Type,       name, path-order (same as, above).
  766.          S = Size, name, type.
  767.          D = Date, time, name, type.
  768.          P = Path,       name, type.
  769.          Css,ee
  770.            = specific Columns of fileid, where 'ss,ee' specify the
  771.              start and end columns, each within the range 1-12.
  772.              The comma (,) must be specified, and the columns in
  773.              ascending order.
  774.          O = sort turned Off.
  775.  
  776.     If not specified, default is '/ON'.
  777.  
  778.  
  779. /R|Y|N|
  780.     Specifies whether to Refresh the FLAK display immediately after
  781.     executing any DOS commands, or wait for a keypress.
  782.  
  783.          Y - The screen is refreshed with the FLAK display immediately
  784.              after completion of the last DOS command.
  785.  
  786.          N - The output from DOS commands may be viewed until a keypress
  787.              restores the FLAK display.
  788.  
  789.              Whenever '/D[nn]' is issued specifying less than the
  790.              maximum number of lines on the physical display, 'Refresh'
  791.              is automatically enabled (/RY).  This leaves any DOS
  792.              command output on the bottom of the display.
  793.  
  794.              Similarly, when '/D*' or '/D[nn]' specifies the maximum
  795.              number of lines, 'Refresh' is automatically disabled.  This
  796.              causes FLAK to wait for a keypress before restoring the
  797.              file list display.
  798.  
  799.  
  800. /S|Y|N|
  801.     Specifies whether maximum RAM Storage is to be allocated for all DOS
  802.     commands or not.
  803.  
  804.          Y - Causes the maximum RAM Storage to be allocated by
  805.              'swapping' FLAK to a disk file.
  806.              This causes increased processing overhead for each DOS
  807.              command executed.
  808.  
  809.          N - Causes DOS commands to utilize whatever RAM Storage is
  810.              available while FLAK is resident in RAM.
  811.  
  812.     If not specified, the default is 'N'.
  813.  
  814.     See 'Resource Utilization & Optimization' for full details.
  815.  
  816.  
  817. /V[c[f,b]]
  818.     Specifies the Video characteristics of various display fields,
  819.     where:
  820.  
  821.          c   - Specifies which field type is to be set, as follows:
  822.  
  823.                    N - Is coded as shown, and represents 'Normal'.
  824.                    H - Is coded as shown, and represents 'Highlighted'.
  825.                    I - Is coded as shown, and represents 'Intense'.
  826.  
  827.                See 'Display Screen' for which field types are used in
  828.                the various display areas.
  829.  
  830.          f,b - Represent the foreground/background color/attribute
  831.                specifications, as listed below.
  832.  
  833.     Monochrome attribute specifications:
  834.  
  835.     1,0  - highlighted                1,8  - underline/blinking
  836.     7,0  - normal                     7,8  - blinking
  837.     9,0  - high intensity/underline   9,8  - high intens/underl./blink.
  838.     14,0 - high intensity             15,8 - high intens/blink.
  839.     7,0  - reverse video              0,15 - reverse video/blink.
  840.  
  841.  
  842.     Color Foreground attribute specifications:
  843.  
  844.     0  - black            6  - brown              11 - light cyan
  845.     1  - blue             7  - white              12 - light red
  846.     2  - green            8  - gray               13 - light magenta
  847.     3  - cyan             9  - light blue         14 - yellow
  848.     4  - red              10 - light green        15 - bright white
  849.     5  - magenta
  850.  
  851.  
  852.     Color Background attribute specifications:
  853.  
  854.     0  - black            6  - brown               11 - cyan/blink.
  855.     1  - blue             7  - white               12 - red/blink.
  856.     2  - green            8  - black/blink.        13 - magenta/blink.
  857.     3  - cyan             9  - blue/blink.         14 - yellow/blink.
  858.     4  - red              10 - green/blink.        15 - white/blink.
  859.     5  - magenta
  860.  
  861.  
  862.     For example, to set 'Normal' fields on a color video screen to cyan
  863.     characters on a black background, enter:
  864.  
  865.          /VN3,0
  866.  
  867.     During FLAK Installation and Setup, the FLAKINST program has a
  868.     utility screen which makes this task an easy one.
  869.  
  870.  
  871. /Y|c|
  872.     Specifies the Substitution Symbol to cause insertion of fileid
  873.     portions in commands, or special Flags to be set during DOS command
  874.     execution.
  875.     If not specified, defaults to '[' (left bracket).
  876.  
  877.     Note:
  878.     Any Substitution Strings coded in a Configuration File must agree
  879.     with the defaulted or specified Symbol.
  880.  
  881.     See 'Command Area: Substitution Strings and Flags'.
  882. %@ign
  883. %@sec Startup: Configuration File - General
  884. The Configuration File is read during FLAK initialization, and may
  885. contain the following types of records (all are optional):
  886.  
  887.     Parameter
  888.     Function Key definition
  889.     Extension default command
  890.     Alias command
  891. %@ign
  892. %@sec Startup: Configuration File - Parameter Record
  893. The 'Parameter' record may contain any valid FLAK command-line
  894. specification:  [listi], and/or [option].
  895.  
  896.     parameter record
  897.  
  898. where:
  899.     See 'Startup: [options]' and 'Startup: [listi]' for allowed
  900.     operands.
  901.  
  902.     Example:
  903.  
  904.          *.exe;*.com;*.bat  /bn  /ey /od
  905.  
  906.     This parameter record would list all executable files in the Current
  907.     Directory, turn the bell off for warnings, run executables with a
  908.     blank Command Area, and order the fileids by date.
  909. %@ign
  910. %@sec Startup: Configuration File - Function Key Record
  911. The 'Function Key' record defines a Function Key.
  912.  
  913.     :Kn  |label|  |[_]command-string|
  914.  
  915. where:
  916.     :K        Is coded as shown.
  917.     n         Is the Function Key number, in the range 4-12.
  918.     label     Specifies the characters to appear in the HelpBar.
  919.               May be 1-8 characters in length, with no blanks.
  920.     [_]command-string
  921.               Is any number of words, separated by blanks, up to a total
  922.               of 66 characters.
  923.               May contain any FLAK command, DOS command, Substitution
  924.               Symbol, or Flag.
  925.               If a leading blank is desired, code the underbar character
  926.               ('_').
  927.  
  928.     Example:
  929.  
  930.          :k4  Refresh  /L=
  931.  
  932.     This labels the F4 key 'Refresh', which issues the FLAK '/L='
  933.     command.
  934.  
  935.     Example:
  936.  
  937.          :k5  C-Comp  cc [n [s
  938.  
  939.     This labels the F5 key 'C-Comp', which causes execution of the 'cc'
  940.     executable.  The filename is passed as a parameter, and maximum DOS
  941.     storage is allocated.
  942. %@ign
  943. %@sec Startup: Configuration File - Extension Record
  944. The 'Extension' record defines the default command for a particular file
  945. extension to be executed when a blank Command Area is detected.  This
  946. allows associating files with appropriate file viewers, editors, etc.
  947.  
  948.     :EXT    |ext|  |[_]command-string...|
  949.             |*  |  |*                   |
  950.  
  951. where:
  952.     :EXT      Is coded as shown.
  953.     ext       Is a valid file extension, with NO period ('.').
  954.               If '*' is coded, every file extension matches.
  955.     [_]command-string...
  956.               Is any number of words, separated by blanks, up to a total
  957.               of 66 characters.
  958.               May contain any FLAK command, DOS command, Substitution
  959.               Symbol, or Flag.
  960.               If a leading blank is desired, code the underbar character
  961.               ('_').
  962.               If '*' is coded, no action is performed.
  963.  
  964.     Example:
  965.  
  966.          :ext  doc  browse [r
  967.  
  968.     Here, a blank Command Area for a '.DOC' file causes the 'browse'
  969.     executable to be run.  After execution, the FLAK display is
  970.     refreshed without a pause.  Note that, by default, the full <fileid>
  971.     will be appended to the command.
  972. %@ign
  973. %@sec Startup: Configuration File - Alias Record
  974. The 'Alias' record defines a command alias/abbreviation.
  975.  
  976.     :ALIAS  |keyword|  |minlen|  |[_]command-string...|
  977.  
  978. where:
  979.  
  980.     :ALIAS    Is coded as shown.
  981.     keyword   Is the 1-to-8 character command which is to be
  982.               replaced.
  983.     minlen    Is the minimum length of 'keyword' which must be
  984.               specified in the Command Area.
  985.     [_]command-string
  986.               Is any number of words, separated by blanks, up to a total
  987.               of 66 characters.
  988.               May contain any FLAK command, DOS command, Substitution
  989.               Symbol, or Flag.
  990.               If a leading blank is desired, code the underbar character
  991.               ('_').
  992.  
  993.     Example:
  994.  
  995.          :alias  purge  4  erase
  996.  
  997.     This defines the following commands to be identical to 'erase':
  998.  
  999.          purge
  1000.          purg
  1001. %@ign
  1002. %@sec Keys: Brief Description (Also available via F1)
  1003. Once the file list is created and displayed, the following keys are
  1004. available (full details below):
  1005.  
  1006. Esc - Clear cmnd; Clear all cmnds; Exit       Bksp - Backspace char
  1007. F1  - HelpPrompt                              Ins  - Toggle Insert mode
  1008. F2  - HelpBar, HelpFile                       Del  - Delete character
  1009. F3  - Show Alternate Information Fields       Home - First screen input
  1010. F4  - }                                       End  - Input start/end
  1011. F5  -  }                                  Ctl-Home - Toggle last screen
  1012. F6  -   }                                 Ctl-Del  - Delete to line end
  1013. F7  -    }                                    PgUp - Next     screen
  1014. F8  -     } User-defined: See HelpBar         PgDn - Previous screen
  1015. F9  -    }                                Ctl-PgUp - First screen
  1016. F10 -   }                                 Ctl-PgDn - Last  screen
  1017. F11 -  }                                      Tabf - Next Command Area
  1018. F12 - }                                       Tabb - Prev Command Area
  1019.                                              Enter - Process Commands
  1020.                                          Ctl-Enter - Show DOS commands
  1021.                                                      but don't execute
  1022. %@ign
  1023. %@sec Keys: ENTER      (execute command areas)
  1024. Enter
  1025.          Causes all Command Areas onscreen to be processed.
  1026. %@ign
  1027. %@sec Keys: CTL-ENTER  (display command areas)
  1028. Ctl-Enter
  1029.          Shows DOS commands but doesn't execute them.
  1030.          Process all Command Areas, but display resulting DOS commands
  1031.          only:  Do not pass them to DOS for execution.  An asterisk
  1032.          ('*') is placed before the command when displayed.
  1033.  
  1034.          This provides a way of testing a command prior to utilization.
  1035. %@ign
  1036. %@sec Keys: ESC        (clear commands, exit)
  1037. Esc      Clear cmnd; Clear all cmnds; Exit menu
  1038.          1st press causes current Command Area to be reset to <fileid>
  1039.                    information.
  1040.          2nd press causes all Command Areas onscreen to be reset.
  1041.          3rd press causes Exit Menu display.
  1042.                    Select desired Option with UP/DOWN ARROWs, then
  1043.                    <ENTER>, or cancel with <ESC>.
  1044. %@ign
  1045. %@sec Keys: F1         (HelpPrompt)
  1046. F1       HelpPrompt
  1047.          Causes a display of available FLAK Commands, Substitution
  1048.          Symbols, and Flags with select/insert capability.
  1049.          To use:
  1050.          * Position the cursor where the Command, Symbol, or Flag is
  1051.            required.
  1052.          * Press <F1>.
  1053.          * Use the ARROW and PAGE keys to select the desired operand.
  1054.          * Press <ENTER> to insert the operand at the cursor.
  1055.            Or, Press <F2> for HelpFile information on selection.
  1056.          * Edit/replace inserted Prompt to complete command input.
  1057.          * Press <ENTER> to issue command.
  1058.  
  1059.          Also contains a display of keyboard usage (but with no prompt
  1060.          capability).
  1061. %@ign
  1062. %@sec Keys: F2         (HelpBar, HelpFile)
  1063. F2       HelpBar, HelpFile
  1064.          1st press causes HelpBar to replace last utilized screen line.
  1065.          2nd press causes HelpFile display.
  1066.                    Once entered, press <F1> for Help on HelpFile.
  1067.  
  1068.          HelpBar is also made visible by the '/HY' command, described
  1069.          elsewhere.
  1070. %@ign
  1071. %@sec Keys: Others     (Detailed Descriptions)
  1072. F3       AltInfo
  1073.          Toggles between left and right portions of pathi fields, and
  1074.          HelpBar (if displayed), and Size or Attributes of files.
  1075.  
  1076. F4 -
  1077. F12      User-definable Function Keys
  1078.          These Function Keys may be defined in the Configuration File.
  1079.  
  1080. Bksp     Backspace char
  1081.          Causes cursor to move left 1 space, the character above it to
  1082.          be erased, and all characters to the right to be moved left.
  1083.  
  1084. Ins      Toggle Insert mode
  1085.          Causes Insert Mode to be turned On, then Off.
  1086.  
  1087. Del      Delete character
  1088.          Causes character above cursor to be deleted, and all characters
  1089.          to the right to move left.
  1090.  
  1091. Home     First screen input
  1092.          Causes cursor to be placed at the beginning of the first
  1093.          Command Area on the current screen.
  1094.  
  1095. End      Input start/end
  1096.          1st press moves cursor to end of current Command Area input.
  1097.          2nd press moves cursor to beginning of current Command Area.
  1098.  
  1099. Ctl-Home Toggle last screen
  1100.          Whenever a FLAK command causes a 'second' display by appending
  1101.          files to the current file list, this keypress will toggle
  1102.          between the current and last display positions.
  1103.  
  1104. Ctl-Del  Delete to line end
  1105.          Deletes all characters from the current cursor position to the
  1106.          end of the current line.
  1107.  
  1108. PgUp     Next screen
  1109.          Display next full screen of file list.
  1110.  
  1111. PgDn     Previous screen
  1112.          Display previous full screen of file list.
  1113.  
  1114. Ctl-PgUp First screen
  1115.          Display first screenful of file list.
  1116.  
  1117. Ctl-PgDn Last screen
  1118.          Display last screenful of file list.
  1119.  
  1120. Tabf     Next Command Area
  1121.          Move cursor to beginning of next Command Area on screen.
  1122.  
  1123. Tabb     Prev Command Area
  1124.          Move cursor to beginning of previous Command Area on screen.
  1125. %@ign
  1126. %@sec Command Area: General
  1127. Once the file list is displayed, DOS commands may be entered on any line
  1128. accessible by the cursor.  Use the Tab, Arrow, and Page keys to position
  1129. the display and cursor and select the desired fileid(s).
  1130.  
  1131. When any input is entered, the <size>, <date>, <time>, and <path> fields
  1132. are cleared, thus expanding the Command Area.
  1133.  
  1134. DOS commands may be entered for any number of the files on a single
  1135. screen, but they are not executed until the <ENTER> key is pressed.
  1136.  
  1137. After a command is executed, it is 'commented-out' by an asterisk being
  1138. placed in column 1 of the Command Area.  If a system error occurs, an
  1139. exclamation mark ('!') is placed in column 1 of the Command Area, and
  1140. the bell is sounded.
  1141. %@ign
  1142. %@sec Command Area: Automatic Fileid Appending
  1143. If a DOS command begins in column 1 of a Command Area, FLAK auto-
  1144. matically adds a blank and the fileid before executing the command.
  1145.  
  1146. For example, by simply entering the following (in column 1):
  1147.  
  1148.     edit
  1149.  
  1150. and pressing <ENTER>, FLAK will pass the command:
  1151.  
  1152.     EDIT fileid
  1153.  
  1154. to DOS for execution (where 'fileid' is from the <fileid> field).
  1155.  
  1156. If the fileid's path is the Current Directory, only the filename and
  1157. extension are inserted.
  1158.  
  1159. If the fileid's path is not the Current Directory, then the path is also
  1160. inserted.
  1161.  
  1162. If the fileid's drive is not the Current Drive, then the drive is also
  1163. inserted.
  1164.  
  1165. As a reminder of Automatic Fileid Appending, FLAK highlights the fileid
  1166. whenever the cursor is in column 1 of the Command Area, or if column 1
  1167. is not blank.
  1168. %@ign
  1169. %@sec Command Area: Automatic Fileid Appending Cancellation
  1170. If a Command Area begins with 1 or more leading blanks, FLAK cancels
  1171. Automatic Fileid Appending.
  1172.  
  1173. Therefore, to execute a DOS command with no fileid, simply enter at
  1174. least 1 leading blank, then the desired command.
  1175.  
  1176. DOS commands, program- and batch-file names may also be entered with
  1177. only portions of the fileid.  See 'Substitution Symbols and Flags' for
  1178. details.
  1179. %@ign
  1180. %@sec Command Area: Automatic Directory Navigation
  1181. Fileids marked '<DIR>' in the <size> field represent sub-directories.
  1182.  
  1183. Fileids '..' represent the parent of the sub-directory in the <path>
  1184. field.
  1185.  
  1186. By entering a blank on a <DIR> display line and pressing <ENTER>, FLAK
  1187. will reset the '<< [listi] specification >>' field from the target
  1188. directory, and rebuild the file list.
  1189.  
  1190. Note:
  1191. The Current Directory is NOT changed.
  1192.  
  1193. Note:
  1194. When changing to a parent ('..') directory, the new file list is
  1195. positioned to the previous sub-directory entry in the list, not at the
  1196. top.
  1197. %@ign
  1198. %@sec Command Area: :EXT (Extension) Processing
  1199. If a Command Area is blank (that is, it begins with 1 or more leading
  1200. blanks, and has no other characters), a check is performed against
  1201. Configuration File :EXT records for a match.  If the <fileid> extension
  1202. is found, then the Command Area is set to the associated :EXT
  1203. 'command-string'.
  1204.  
  1205. Thus, for example, if the following Configuration File record was
  1206. specified:
  1207.  
  1208.     :ext  txt  edit
  1209.  
  1210. And, at least 1 blank (and nothing else) was entered on the following
  1211. FLAK display line:
  1212.  
  1213.     MYFILE   TXT  _   200  06/02/92  10:00  c:\curdir
  1214.  
  1215. Then, the following DOS command would be executed:
  1216.  
  1217.     edit MYFILE.TXT
  1218.  
  1219. Note:
  1220. :EXT processing utilizes Automatic Fileid Appending, even though the
  1221. Command Area begins with a blank.
  1222.  
  1223. See 'Startup:  Configuration File - Extension Record' for details.
  1224. %@ign
  1225. %@sec Command Area: :ALIAS (Alias) Processing
  1226. After the :EXT check is performed, the first word in the Command Area is
  1227. compared against Configuration File :ALIAS records for a match.
  1228.  
  1229. If a match is found, the first word in the Command Area is replaced by
  1230. the associated :ALIAS 'command-string'.
  1231.  
  1232. Example:
  1233. If the following Configuration File record was specified:
  1234.  
  1235.     :alias  display 1 viewfile [r
  1236.  
  1237. And, the single-character command 'd' was entered on the following FLAK
  1238. display line:
  1239.  
  1240.     MYFILE   TXT  d   200  06/02/92  10:00  c:\curdir
  1241.  
  1242. Then, the following DOS command would be executed:
  1243.  
  1244.     viewfile MYFILE.TXT
  1245.  
  1246. Additionally, the '[R' flag causes FLAK to refresh the screen
  1247. immediately after command execution.  That is, upon exiting the VIEWFILE
  1248. program, FLAK will restore the file list display, without user
  1249. intervention.
  1250.  
  1251. Obviously, you may create abbreviations in addition to aliases.
  1252. %@ign
  1253. %@sec Command Area: Substitution Strings and Flags
  1254. In either the Command Area, :EXT-, or :ALIAS- 'command-string', special
  1255. 'Substitution Strings' and/or 'Flags' may be specified to cause
  1256. insertion of the <fileid> (or parts of it) into the command, or cause
  1257. special processing during the DOS command execution.
  1258.  
  1259. If the Substitution String contains any part of the fileid, Automatic
  1260. Fileid Appending is cancelled.
  1261.  
  1262. Note:
  1263. The left bracket is the default Substitution Symbol, and thus is
  1264. ENTERED AS SHOWN.  This may be changed by the '/Yc' command, described
  1265. elsewhere.
  1266.  
  1267. String    Action ('*' = Automatic Fileid Appending NOT cancelled)
  1268. ───────── ──────────────────────────────────────────────────────────
  1269. [b        Insert fileid with following blank  ('b' = blank)
  1270. [C        Insert fileid with Complete drive and path
  1271. [F        Insert fileid with no following blank
  1272. [G        Insert fileid without path
  1273. [D        Insert file's drive and colon (:)
  1274. [N        Insert file name
  1275. [T        Insert file type (extension)
  1276. [E        Insert file type (extension)
  1277. [P        Insert file's path (with drive and colon)
  1278. [Q        Insert file's path (without drive)
  1279. [+[++..]  Insert next     (1st, 2nd, 3rd, ...) fileid in list
  1280. [-[--..]  Insert previous (1st, 2nd, 3rd, ...) fileid in list
  1281. [[        Insert Substitution Symbol
  1282. [R       *Display can be Refreshed after this DOS command
  1283. [S       *Maximum Storage is required for this DOS command
  1284.  
  1285. Example:
  1286.  ┌───────────────────────────────────────────────────────────────────┐
  1287.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1288.  │  1/3     *.fta                                                    │
  1289.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1290.  │FNBBBB   FTB  erase [n.*<ENTER>                                    │
  1291.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  1292.  └───────────────────────────────────────────────────────────────────┘
  1293.  
  1294. Causes the following command to be issued:
  1295.  
  1296.     ERASE FNBBBB.*
  1297.  
  1298. Note:
  1299. Pay careful attention to the Current Drive/Current Directory when
  1300. issuing global commands (those with '*' or '?'  -- effecting more than
  1301. just the <fileid> file).
  1302.  
  1303. See 'Command Area: ERASE/DELETE **WARNING**' for details.
  1304.  
  1305. Example:
  1306.  ┌───────────────────────────────────────────────────────────────────┐
  1307.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1308.  │  1/3     *.fta                                                    │
  1309.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1310.  │FNBBBB   FTB  compare [ [+<ENTER>                                  │
  1311.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  1312.  └───────────────────────────────────────────────────────────────────┘
  1313.  
  1314. Causes the following command to be issued:
  1315.  
  1316.     COMPARE  FNBBBB.FTB  FNCCCC.FTC
  1317. %@ign
  1318. %@sec Command Area: Application/Command Execution ('Launching')
  1319. To run an executable (file extension of .BAT, .COM, or .EXE) enter:
  1320.  
  1321.     [c<ENTER>
  1322.  
  1323. This will cause the Complete <path>/<fileid> to be passed to DOS.
  1324.  
  1325. If parameters are desired, they may be entered as follows:
  1326.  
  1327.     [c  parm1  parm2  ...<ENTER>
  1328.  
  1329. Additionally, if the '/EY' command has been issued, Executables can be
  1330. run simply by specifying a leading blank in the Command Area.
  1331.  
  1332. Note:
  1333. This facility allows you to bypass the normal DOS PATH directory search
  1334. order, and run a specific executable.  This is convenient for testing
  1335. new versions of programs that are not in the PATH definition.
  1336.  
  1337. Example:
  1338.  ┌───────────────────────────────────────────────────────────────────┐
  1339.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1340.  │  1/3     *.fta                                                    │
  1341.  │MYAPPLIC BAT  [c [+ <ENTER>                                        │
  1342.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1343.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1344.  └───────────────────────────────────────────────────────────────────┘
  1345.  
  1346. This would cause the following command to be passed to DOS:
  1347.  
  1348.     c:\mydir\MYAPPLIC.BAT FNBBBB.FTB
  1349. %@ign
  1350. %@sec Command Area: CD (Change Directory)
  1351. A DOS 'cd' (Change Directory) command is intercepted anywhere in a
  1352. Command Area, and even if entered in column 1, is NOT automatically
  1353. appended.
  1354.  
  1355. The specified directory is made the new Current Directory, the bell is
  1356. sounded, and the '<< current directory >>' field is updated.
  1357.  
  1358. Note:
  1359. The [listi] specification (and thus the current file list) is NOT
  1360. changed.
  1361.  
  1362. To Change Directory and reset the file list simultaneously, see
  1363. 'FLAK Command: /CL (Change and List)'.
  1364. %@ign
  1365. %@sec Command Area: D: (Drive)
  1366. The DOS 'd:'  (Drive) command is intercepted anywhere in a Command Area,
  1367. and even if entered in column 1, is NOT automatically appended.
  1368.  
  1369. After a 'd:'  command completes, the '<<<< current drive/directory >>>>'
  1370. display area is updated with the new Current Drive, and the bell is
  1371. sounded.
  1372.  
  1373. The [listi] specification (and thus the current file list) is NOT
  1374. changed.
  1375.  
  1376. To change the current Drive and reset the file list simultaneously, see
  1377. 'FLAK Command: /CL (Change and List)'.
  1378. %@ign
  1379. %@sec Command Area: RENAME (Move)
  1380. The 'RENAME' command is intercepted anywhere in a Command Area, and may
  1381. be used to rename files and sub-directories.
  1382.  
  1383. Additionally, if you specify a different path in the new name of a file,
  1384. it will be removed from the old directory, and placed in the new
  1385. directory, thus 'moving' the file.
  1386.  
  1387. After a successful rename, the file list and display are updated with
  1388. the new fileid and/or path information.
  1389.  
  1390. If 'd:'  is included in the old fileid, it must be the same in the new
  1391. fileid:  You cannot move a file to a new drive.
  1392.  
  1393. If the file is not in the Current Directory, and no directory is
  1394. specified in the new fileid, the original (old) directory is assumed.
  1395.  
  1396. No 'wild' characters are allowed in either the old or new fileids.
  1397. %@ign
  1398. %@sec Command Area: ERASE/DELETE **WARNING**
  1399. Although no special processing is performed for the DOS 'ERASE' and
  1400. 'DELETE' commands, they are mentioned here to describe the processing
  1401. that FLAK performs for each <fileid> with a DOS command in its Command
  1402. Area.
  1403.  
  1404. After a DOS command completes, FLAK checks for the existence of <fileid>
  1405. in its displayed <path>.  If the file still exists, all the fields in
  1406. the display line are updated.  If the file has been erased, the file
  1407. statistics fields are replaced with:
  1408.  
  1409.     -- not found --
  1410.  
  1411. However, if you execute commands or batch files which affect files other
  1412. than the one in the <fileid> field, FLAK will not update those fileid's
  1413. fields, as it has no way of knowing which files have been affected.
  1414.  
  1415. In fact, if a command creates new files, they will not even appear in
  1416. the file list until the list is manually re-built.
  1417.  
  1418. This facet of FLAK may be overlooked in many cases:
  1419. For example, assume you execute a program which updates a <fileid>
  1420. already in the file list.  Although the statistics may be incorrect, you
  1421. may still access the file, and issue DOS commands against it, so long as
  1422. the <fileid> and <path> information remain correct.
  1423.  
  1424. However, assume you execute a program which creates a file only
  1425. sometimes (for example, a compiler creating an error-message file, only
  1426. when errors occur):  Unless the fileid is in the display list prior to
  1427. the file's creation, or the list is re-built, the file's existence may
  1428. go unnoticed!
  1429.  
  1430. See the FLAK Command '/L=' for a quick method of rebuilding the file
  1431. list.
  1432. %@ign
  1433. %@sec FLAK Command: General
  1434. In addition to DOS commands, FLAK supports 'FLAK Commands' which
  1435. modify the file list, DOS environment, or perform other functions.
  1436.  
  1437. FLAK Commands begin in column 1 of the Command Area, and start with
  1438. the '/' (slash) character.
  1439.  
  1440. Normally they should be executed one-at-a-time, and followed immediately
  1441. by <ENTER>.
  1442.  
  1443. However, those noted by '##' may be entered multiple times on a screen
  1444. prior to <ENTER>.
  1445.  
  1446. A concise list of all FLAK Commands with HelpPrompt capability is
  1447. available via the <F1> key.
  1448.  
  1449. Each FLAK Command is discussed in the following sections.
  1450. %@ign
  1451. %@sec FLAK Command: =            (Repeat Previous Command)
  1452. =         ##  Reset Command Area with last command, and execute.
  1453. =?            Reset with Selected previous command, and execute.
  1454.               A menu is presented for the selection.
  1455.  
  1456. Example:
  1457.  ┌───────────────────────────────────────────────────────────────────┐
  1458.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1459.  │  1/3     *.fta                                                    │
  1460.  │FNAAAA   FTA  erase                                                │
  1461.  │FNBBBB   FTB  =                                                    │
  1462.  │FNCCCC   FTC  =<ENTER>                                             │
  1463.  └───────────────────────────────────────────────────────────────────┘
  1464.  
  1465. Results in the following commands:
  1466.  
  1467.     ERASE FNAAAA.FTA
  1468.     ERASE FNBBBB.FTB
  1469.     ERASE FNCCCC.FTC
  1470. %@ign
  1471. %@sec FLAK Command: ?            (Reset Previous Command)
  1472. ?         ##  Reset Command Area with last command, but don't execute.
  1473. ??            Reset with Selected previous command, but don't execute.
  1474.               A menu is presented for the selection.
  1475.  
  1476. Example:
  1477.  ┌───────────────────────────────────────────────────────────────────┐
  1478.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1479.  │  1/3     *.fta                                                    │
  1480.  │FNAAAA   FTA  erase<ENTER>                                         │
  1481.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1482.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1483.  └───────────────────────────────────────────────────────────────────┘
  1484.  
  1485. Followed by:
  1486.  
  1487.  ┌───────────────────────────────────────────────────────────────────┐
  1488.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1489.  │  1/3     *.fta                                                    │
  1490.  │FNAAAA   FTA           -- not found --  c:\mydir\                  │
  1491.  │FNBBBB   FTB  ?                                                    │
  1492.  │FNCCCC   FTC  ?<ENTER>                                             │
  1493.  └───────────────────────────────────────────────────────────────────┘
  1494.  
  1495. would result in the following:
  1496.  
  1497.  ┌───────────────────────────────────────────────────────────────────┐
  1498.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1499.  │  1/3     *.fta                                                    │
  1500.  │FNAAAA   FTA           -- not found --  c:\mydir\                  │
  1501.  │FNBBBB   FTB  erase                                                │
  1502.  │FNCCCC   FTC  erase                                                │
  1503.  └───────────────────────────────────────────────────────────────────┘
  1504.  
  1505. At this point, you can hit <ENTER> to execute the commands, or <ESC> 2
  1506. times, to clear all Command Areas.
  1507. %@ign
  1508. %@sec FLAK Command: /            (Make first line in display)
  1509. /             Make this line first in display.
  1510. /[nnn]        Make line number 'nnn' first in display.
  1511.  
  1512. Example:
  1513.  ┌───────────────────────────────────────────────────────────────────┐
  1514.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1515.  │  1/3     *.fta                                                    │
  1516.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1517.  │FNBBBB   FTB  /<ENTER>                                             │
  1518.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1519.  └───────────────────────────────────────────────────────────────────┘
  1520.  
  1521. Results in the following:
  1522.  ┌───────────────────────────────────────────────────────────────────┐
  1523.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1524.  │  2/3     *.fta                                                    │
  1525.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1526.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1527.  │                                                                   │
  1528.  └───────────────────────────────────────────────────────────────────┘
  1529.  
  1530.  
  1531. Example:
  1532.  ┌───────────────────────────────────────────────────────────────────┐
  1533.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1534.  │  1/3     *.fta                                                    │
  1535.  │FNAAAA   FTA  /3                                                   │
  1536.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1537.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1538.  └───────────────────────────────────────────────────────────────────┘
  1539.  
  1540. Results in the following:
  1541.  
  1542.  ┌───────────────────────────────────────────────────────────────────┐
  1543.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1544.  │  3/3     *.fta                                                    │
  1545.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1546.  │                                                                   │
  1547.  │                                                                   │
  1548.  └───────────────────────────────────────────────────────────────────┘
  1549. %@ign
  1550. %@sec FLAK Command: /A           (Search specific file Attributes)
  1551. /A|N|x[x..]|  Search Normal, System, Dir, Hidden, Archive, Read-only
  1552.               files in subsequent searches.
  1553.               See 'Startup: [listi]'  for details.
  1554.  
  1555. Example:
  1556.  ┌───────────────────────────────────────────────────────────────────┐
  1557.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1558.  │  1/3     *.fta                                                    │
  1559.  │FNAAAA   FTA  /anr<ENTER>                                          │
  1560.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1561.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1562.  └───────────────────────────────────────────────────────────────────┘
  1563.  
  1564. Causes the next files search to include only Read/only files.  The 'n'
  1565. sets 'Normal', and the 'r' sets Read/only.
  1566.  
  1567. The 'v/as' display field is set to the characters representing the file
  1568. attributes specified.
  1569. %@ign
  1570. %@sec FLAK Command: /B           (Bell is audible or not)
  1571. /B|Y|N|       Bell is audible or not for warnings
  1572.               The bell is always sounded for severe errors.
  1573.  
  1574. Example:
  1575.  ┌───────────────────────────────────────────────────────────────────┐
  1576.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1577.  │  1/3     *.fta                                                    │
  1578.  │FNAAAA   FTA  /bn                                                  │
  1579.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1580.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1581.  └───────────────────────────────────────────────────────────────────┘
  1582.  
  1583. Causes the Bell to be silenced for warning messages.
  1584. No change in the display occurs.
  1585. %@ign
  1586. %@sec FLAK Command: /CD          (Change Drive/Directory)
  1587. /CD[pathi]    Make specified [drive:][\path\] the Current Drive and
  1588.               Current Directory.
  1589.               If no [pathi] is supplied, no action is taken.
  1590.               If [drive:] is not specified, the Current Drive is used.
  1591.               If [\path\] is not specified, the Current Directory on the
  1592.               current (or specified) drive is used.
  1593.  
  1594.               Note:
  1595.               The file list is not changed.
  1596.  
  1597. Example:
  1598.  ┌───────────────────────────────────────────────────────────────────┐
  1599.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1600.  │  1/3     *.fta                                                    │
  1601.  │FNAAAA   FTA  /cdb:\backup\                                        │
  1602.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1603.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1604.  └───────────────────────────────────────────────────────────────────┘
  1605.  
  1606. This will cause the Current Drive and Directory to be changed, but not
  1607. the file list, as follows:
  1608.  
  1609.  ┌───────────────────────────────────────────────────────────────────┐
  1610.  │flak 1.01 b:\backup\                            Mon 01/02/92, 13:45│
  1611.  │  1/3     *.fta                                                    │
  1612.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1613.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1614.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1615.  └───────────────────────────────────────────────────────────────────┘
  1616. %@ign
  1617. %@sec FLAK Command: /CL          (Change Drive/Directory and List)
  1618. /CL=          Rebuild file List from Current Directory.
  1619.  
  1620. /CL?          Make Current/List from Selected previous specification.
  1621.               A menu box is presented with previous [listi]
  1622.               specifications, allowing selection.
  1623.  
  1624. /CL[pathi]    Make specified [drive:][\path\] the Current Drive and
  1625.               Current Directory and List the files therein.
  1626.               If no [pathi] is supplied, the Current Directory is used.
  1627.               If [drive:] is not specified, the Current Drive is used.
  1628.               If [\path\] is not specified, the Current Directory is
  1629.               used, unless [drive:] is new, in which case, '\' (the
  1630.               root) is used.
  1631.               [fileid] may also be specified to filter the list.
  1632.               Note:
  1633.               [\path\], if coded, must always include the ending '\'
  1634.               to indicate [\path\], rather than [fileid].
  1635.  
  1636.  
  1637.  
  1638.  
  1639. Example:
  1640.  ┌───────────────────────────────────────────────────────────────────┐
  1641.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1642.  │  1/3     *.fta                                                    │
  1643.  │FNAAAA   FTA  /cl=<ENTER>                                          │
  1644.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1645.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1646.  └───────────────────────────────────────────────────────────────────┘
  1647.  
  1648. This will cause all files in the c:\mydir\ directory to be listed.
  1649.  
  1650.  
  1651. Example:
  1652.  ┌───────────────────────────────────────────────────────────────────┐
  1653.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1654.  │  1/3     *.fta                                                    │
  1655.  │FNAAAA   FTA  /clb:\prod\*.bat<ENTER>                              │
  1656.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1657.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1658.  └───────────────────────────────────────────────────────────────────┘
  1659.  
  1660. This will cause the b:\prod\ directory to become the Current Directory,
  1661. and all the .BAT files in it to be listed.  Note the change in drive.
  1662.  
  1663.  
  1664. Example:
  1665. Assume the following:
  1666.  ┌───────────────────────────────────────────────────────────────────┐
  1667.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1668.  │  1/3     *.fta                                                    │
  1669.  │SUBDIR        <DIR>    --------  -----  c:\mydir\                  │
  1670.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1671.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1672.  └───────────────────────────────────────────────────────────────────┘
  1673.  
  1674. Then, the following:
  1675.  ┌───────────────────────────────────────────────────────────────────┐
  1676.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1677.  │  1/3     *.fta                                                    │
  1678.  │SUBDIR        /cl[c\<ENTER>                                        │
  1679.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1680.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1681.  └───────────────────────────────────────────────────────────────────┘
  1682.  
  1683. would make the SUBDIR directory the Current Directory, and list all
  1684. the files within it.
  1685. %@ign
  1686. %@sec FLAK Command: /D           (Display 'nn' or maximum fileids)
  1687. /D|nn|*|      Display 'nn' or maximum number of fileid's.
  1688.               See 'Startup: [options]' for full details.
  1689.  
  1690. Example:
  1691.  ┌───────────────────────────────────────────────────────────────────┐
  1692.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1693.  │  1/3     *.fta                                                    │
  1694.  │FNAAAA   FTA  /d*<ENTER>                                           │
  1695.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1696.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1697.  └───────────────────────────────────────────────────────────────────┘
  1698.  
  1699. would result in the maximum number of fileids to be displayed on each
  1700. screen.
  1701. %@ign
  1702. %@sec FLAK Command: /DI          (Display <fileid> or specified file)
  1703. /DI[fileid]   Display <fileid> or specified file.
  1704.  
  1705.               The file is displayed by an internal FLAK routine which
  1706.               provides convenient scroll capability.
  1707.  
  1708.               Once entered, press <F1> for Help on its use.
  1709. Example:
  1710.  ┌───────────────────────────────────────────────────────────────────┐
  1711.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1712.  │  1/3     *.fta                                                    │
  1713.  │FNAAAA   FTA  /di                                                  │
  1714.  │FNBBBB   FTB  =                                                    │
  1715.  │FNCCCC   FTC  /diabc.def<ENTER>                                    │
  1716.  └───────────────────────────────────────────────────────────────────┘
  1717.  
  1718. This would cause first the file 'FNAAAA.FTA' to be displayed, then file
  1719. 'FNBBBB.FTB', then file 'ABC.DEF'
  1720. %@ign
  1721. %@sec FLAK Command: /E           (Execute .BAT, .COM, .EXE files)
  1722. /E|Y|N|       Execute .BAT, .COM, .EXE files, or use Config File :EXT.
  1723.               See 'Startup: [options]' for full details.
  1724.  
  1725. Example:
  1726.  ┌───────────────────────────────────────────────────────────────────┐
  1727.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1728.  │  1/3     *.fta                                                    │
  1729.  │FNAAAA   FTA  /ey<ENTER>                                           │
  1730.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1731.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1732.  └───────────────────────────────────────────────────────────────────┘
  1733.  
  1734. This causes a leading blank Command Area to run executable files.
  1735. %@ign
  1736. %@sec FLAK Command: /F           (Find fileid with(out) chars)
  1737. /F[!][cc.cc]  Find (not) specific fileid in list.
  1738. /F[!][ccc]    Find (not) filename with specified characters (in list).
  1739. /F[!].[ccc]   Find (not) filetype with specified characters (in list).
  1740. /F[!]\        Find (not) same path as this fileid's         (in list).
  1741.  
  1742.               Characters specified may be 1-8 for filename searches, and
  1743.               1-3 for filetype searches.
  1744.  
  1745.               When successful, the <fileid> which satisifes the search
  1746.               is made the first <fileid> on the screen.
  1747.  
  1748. Example:
  1749.  ┌───────────────────────────────────────────────────────────────────┐
  1750.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1751.  │  1/3     *.fta                                                    │
  1752.  │FNAAAA   FTA  /fnb<ENTER>                                          │
  1753.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1754.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1755.  └───────────────────────────────────────────────────────────────────┘
  1756.  
  1757. Results in the following:
  1758.  ┌───────────────────────────────────────────────────────────────────┐
  1759.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1760.  │  2/3     *.fta                                                    │
  1761.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1762.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1763.  │                                                                   │
  1764.  └───────────────────────────────────────────────────────────────────┘
  1765.  
  1766. Example:
  1767.  ┌───────────────────────────────────────────────────────────────────┐
  1768.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1769.  │  1/3     *.fta                                                    │
  1770.  │FNAAAA   FTA  /f.tc<ENTER>                                         │
  1771.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1772.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1773.  └───────────────────────────────────────────────────────────────────┘
  1774.  
  1775. Results in the following:
  1776.  ┌───────────────────────────────────────────────────────────────────┐
  1777.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1778.  │  3/3     *.fta                                                    │
  1779.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1780.  │                                                                   │
  1781.  │                                                                   │
  1782.  └───────────────────────────────────────────────────────────────────┘
  1783. %@ign
  1784. %@sec FLAK Command: /G           (Get Project disk file data)
  1785. /G[fileid]    Get Project disk file and list files therein.
  1786.               If [fileid] is not specified, 'WRK.FLK' is used.
  1787.               See 'Project files' for full details.
  1788.  
  1789. /G@[fileid]   Get Project disk file [listi] specification and list.
  1790.               Specifies a file to be read which contains a [listi]
  1791.               specification as the first record.
  1792.               If [fileid] is not specified, 'WRK.FLK' is used.
  1793.               See 'Project files' for full details.
  1794.  
  1795. Example:
  1796.  ┌───────────────────────────────────────────────────────────────────┐
  1797.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1798.  │  1/3     *.fta                                                    │
  1799.  │FNAAAA   FTA  /glist1.flk<ENTER>                                   │
  1800.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1801.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1802.  └───────────────────────────────────────────────────────────────────┘
  1803.  
  1804. Results in the file 'LIST1.FLK' being read, and the display being
  1805. rebuilt from the <fileid> and <path> records within.
  1806. %@ign
  1807. %@sec FLAK Command: /H           (HelpBar visible or not)
  1808. /H|Y|N|       Specifies whether the HelpBar is visible or not.
  1809.  
  1810.               See 'FLAK [options]' for full details.
  1811.  
  1812. Example:
  1813.  ┌───────────────────────────────────────────────────────────────────┐
  1814.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1815.  │  1/3     *.fta                                                    │
  1816.  │FNAAAA   FTA  /hy<ENTER>                                           │
  1817.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1818.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1819.  └───────────────────────────────────────────────────────────────────┘
  1820.  
  1821. This makes the HelpBar visible.
  1822. %@ign
  1823. %@sec FLAK Command: /K           (Display/reset Function Keys)
  1824. /K[nn]        Display/reset Function Key labels/definitions.
  1825.  
  1826.               If 'nn' (which must be in the range 4-12) is entered, the
  1827.               specific Function Key label/definition is displayed, and
  1828.               the user allowed to reset them.
  1829.  
  1830.               The new Function Key definition is valid until reset
  1831.               again, or until FLAK is exited.  The new definition is not
  1832.               saved in the Configuration File.
  1833. %@ign
  1834. %@sec FLAK Command: /L           (Reset [listi] data and list)
  1835. /L=           Rebuild List with current [listi] specification.
  1836.               The Current Directory is not changed.
  1837.  
  1838. /L?           Set [listi] with Selected previous specification.
  1839.               A menu box is presented with previous [listi]
  1840.               specifications, allowing selection.
  1841.               The Current Directory is not changed.
  1842.  
  1843. /L            Set [listi] with (modified) current specification.
  1844.               An input box is presented with the current [listi]
  1845.               specification, which may be modified.
  1846.               The Current Directory is not changed.
  1847.  
  1848. /L[listi]     Set [listi] specification and create new file list.
  1849.               All valid [listi] specifications may be entered.
  1850.  
  1851.               See 'Startup [listi]' for full details.
  1852.  
  1853.               The Current Directory is not changed.
  1854.  
  1855. Example:
  1856.  ┌───────────────────────────────────────────────────────────────────┐
  1857.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1858.  │  1/3     *.fta                                                    │
  1859.  │FNAAAA   FTA  /L=<ENTER>                                           │
  1860.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1861.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1862.  └───────────────────────────────────────────────────────────────────┘
  1863.  
  1864. Causes the file list to be rebuilt using '*.fta'.  This simply causes
  1865. the list to be 'refreshed', and is a good candidate for a Function Key
  1866. definition in the Configuration File.
  1867.  
  1868.  
  1869. Example:
  1870.  ┌───────────────────────────────────────────────────────────────────┐
  1871.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1872.  │  1/3     *.fta                                                    │
  1873.  │FNAAAA   FTA  /L\dir2\a*.bat<ENTER>                                │
  1874.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1875.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1876.  └───────────────────────────────────────────────────────────────────┘
  1877.  
  1878. Causes the [listi] specification to be reset to '\dir2\a*.bat', and any
  1879. files meeting that specification to be listed.
  1880.  
  1881.  
  1882. Example:
  1883.  ┌───────────────────────────────────────────────────────────────────┐
  1884.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1885.  │  1/3     *.fta                                                    │
  1886.  │FNAAAA   FTA  /L[p<ENTER>              (c:\mydir\)                 │
  1887.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1888.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1889.  └───────────────────────────────────────────────────────────────────┘
  1890.  
  1891. Causes the [listi] specification to be reset to 'c:\mydir\', and all
  1892. files in that directory to be listed.
  1893. %@ign
  1894. %@sec FLAK Command: /L+          (Append [listi] data and list)
  1895. /L+[listi]    Append current [listi] with new specification, and append
  1896.               file list with resulting <fileid>'s.
  1897.               '/L+' is specified as shown.
  1898.               All valid [listi] specifications may be entered.
  1899.               See 'Startup [listi]' for full details.
  1900.  
  1901.               If any files are found, they are appended to the current
  1902.               file list, and the display is positioned to the new files.
  1903.  
  1904.               Toggle current/last display with <CTL-HOME> keypress.
  1905.  
  1906.               Execute '/O...'  (Order) or '/M...'  (Move) commands to
  1907.               merge both lists.
  1908.  
  1909.               The Current Directory is not changed.
  1910.  
  1911. Example:
  1912.  ┌───────────────────────────────────────────────────────────────────┐
  1913.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1914.  │  1/3     *.fta                                                    │
  1915.  │FNAAAA   FTA  /L+\dir2\a*.bat<ENTER>                               │
  1916.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1917.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1918.  └───────────────────────────────────────────────────────────────────┘
  1919.  
  1920. Causes the listi specification to be appended with '\dir2\a*.bat', and
  1921. any files meeting that specification to be added to the list.
  1922.  
  1923.  
  1924. Example:
  1925.  ┌───────────────────────────────────────────────────────────────────┐
  1926.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1927.  │  1/3     *.fta                                                    │
  1928.  │FNAAAA   FTA  /L+/aa;\*.bat<ENTER>                                 │
  1929.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1930.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1931.  └───────────────────────────────────────────────────────────────────┘
  1932.  
  1933. Causes the [listi] specification to be appended and those files to be
  1934. appended to the list.  The specification includes all .BAT files in the
  1935. root (\) directory with the Archive flag set on.
  1936. %@ign
  1937. %@sec FLAK Command: /M           (Mark/Move fileids in the list)
  1938. /M        ##  Mark <fileid> for subsequent '/MH' to Move it in list.
  1939.               Mark any number of <fileid>'s on any screens in the
  1940.               current file list.
  1941.               The files will be moved in the order they are marked.
  1942.               All files marked on a screen via a single <ENTER>, are
  1943.               ordered top to bottom as they appear. To change the
  1944.               order, issue <ENTER> after each '/M'.
  1945.  
  1946. /MM           Start/end block of <fileids> to Move.
  1947.               Enter 2 times anywhere in file list to mark all included
  1948.               <fileids> for subsequent '/MH'.
  1949.  
  1950. /MH           Move Marked <fileid>'s Here in list.
  1951.               Enter after all '/M' or both '/MM' commands.
  1952.  
  1953. Example:
  1954.  ┌───────────────────────────────────────────────────────────────────┐
  1955.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1956.  │  1/3     *.fta                                                    │
  1957.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1958.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1959.  │FNCCCC   FTC  /m<ENTER>                                            │
  1960.  └───────────────────────────────────────────────────────────────────┘
  1961.  
  1962. Followed by:
  1963.  ┌───────────────────────────────────────────────────────────────────┐
  1964.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1965.  │  1/3     *.fta                                                    │
  1966.  │FNAAAA   FTA  /mh<ENTER>                                           │
  1967.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1968.  │FNCCCC   FTC  *m                                                   │
  1969.  └───────────────────────────────────────────────────────────────────┘
  1970.  
  1971. Results in the following:
  1972.  ┌───────────────────────────────────────────────────────────────────┐
  1973.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1974.  │  1/3     *.fta                                                    │
  1975.  │FNCCCC   FTC      100  06/21/92  10:00  c:\mydir\                  │
  1976.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  1977.  │FNBBBB   FTB      100  06/21/92  10:00  c:\mydir\                  │
  1978.  └───────────────────────────────────────────────────────────────────┘
  1979. %@ign
  1980. %@sec FLAK Command: /O           (Order files by field value)
  1981. /O[x[ss,ee]]  Order file list by Attrib, Name, Ext. (Type), Size,
  1982.                                  Date, Path, Cols ss-ee, Off
  1983.               If no Order character is specified, the list is ordered
  1984.               according to the current character.
  1985.  
  1986.               See 'FLAK [options]' for full details.
  1987.  
  1988. Example:
  1989.  ┌───────────────────────────────────────────────────────────────────┐
  1990.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  1991.  │  1/3     *.fta                                                    │
  1992.  │FNAAAA   FTA  /od<ENTER>                                           │
  1993.  │FNBBBB   FTB      200  06/22/92  10:00  c:\mydir\                  │
  1994.  │FNCCCC   FTC      300  06/23/92  10:00  c:\mydir\                  │
  1995.  └───────────────────────────────────────────────────────────────────┘
  1996.  
  1997. Results in the following:
  1998.  ┌───────────────────────────────────────────────────────────────────┐
  1999.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2000.  │  1/3     *.fta                                                    │
  2001.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2002.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2003.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  2004.  └───────────────────────────────────────────────────────────────────┘
  2005.  
  2006. Where the file list has been ordered by the <date> and <time> fields, in
  2007. descending order.
  2008. %@ign
  2009. %@sec FLAK Command: /P           (Put fileid|[listi] to disk file)
  2010. /P        ##  Put <fileid> and <path> fields to output file.
  2011.  
  2012.               The '/P' command writes records to 'Project Files' which
  2013.               can subsequently be read by the '/G' (Get) command so that
  2014.               specific file lists of <fileid>/<path> information may be
  2015.               created, saved, and used.
  2016.  
  2017.               See 'Project Files' for full details.
  2018.  
  2019. /PO[fileid]   Open file for subsequent Put output.
  2020.               If [fileid] not specified, 'WRK.FLK' is used.
  2021.  
  2022. /PL           Put current [listi] string to output file.
  2023.  
  2024. /PP           Start/Put block of <fileids> to output file.
  2025.               Enter 2 times anywhere in file list to Put all
  2026.               included <fileids>/<paths>.
  2027.  
  2028. /PC           Close current Put file.
  2029.  
  2030. Note:
  2031. For any Put operation, if no output file is open, the default file
  2032. 'WRK.FLK' is automatically opened.
  2033.  
  2034. All Put operations cause appending to the output file, no existing
  2035. records are ever lost.
  2036.  
  2037.  
  2038. Example:
  2039.  ┌───────────────────────────────────────────────────────────────────┐
  2040.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2041.  │  1/3     *.fta                                                    │
  2042.  │FNAAAA   FTA  /pp                                                  │
  2043.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2044.  │FNCCCC   FTC  /pp                                                  │
  2045.  └───────────────────────────────────────────────────────────────────┘
  2046.  
  2047. Would cause the following records to be written to file 'WRK.FLK':
  2048.  
  2049.     FNAAAA.FTA   C:\MYDIR
  2050.     FNBBBB.FTB   C:\MYDIR
  2051.     FNCCCC.FTC   C:\MYDIR
  2052. %@ign
  2053. %@sec FLAK Command: /R           (Refresh display after DOS)
  2054. /R|Y|N|       Specifies whether to Refresh the screen after executing
  2055.               any DOS commands, or clear it and restore the FLAK display
  2056.               automatically.
  2057.  
  2058.               See 'Startup:  [options]' for full details.
  2059.  
  2060. Example:
  2061.  ┌───────────────────────────────────────────────────────────────────┐
  2062.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2063.  │  1/3     *.fta                                                    │
  2064.  │FNAAAA   FTA  /rn                                                  │
  2065.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2066.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2067.  └───────────────────────────────────────────────────────────────────┘
  2068.  
  2069. Causes the last screenful of DOS command output to remain visible until
  2070. the user hits any key.
  2071. %@ign
  2072. %@sec FLAK Command: /S           (Maximum RAM Storage required)
  2073. /S|Y|N|       Specifies whether maximum RAM Storage is to be allocated
  2074.               for all DOS commands or not.
  2075.  
  2076.               See 'FLAK [options]' and 'Resource Utilization &
  2077.               Optimization' for full details.
  2078.  
  2079. Example:
  2080.  ┌───────────────────────────────────────────────────────────────────┐
  2081.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2082.  │  1/3     *.fta                                                    │
  2083.  │FNAAAA   FTA  /sy                                                  │
  2084.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2085.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2086.  └───────────────────────────────────────────────────────────────────┘
  2087.  
  2088. Causes the maximum amount of RAM storage to be made available during
  2089. every DOS command.
  2090. %@ign
  2091. %@sec FLAK Command: /T           (Search Tree for all occurrences)
  2092. /T[pathi]     Search Tree for all occurrences of fileid.
  2093.               If [pathi] is specified, the search begins at
  2094.               [drive:][\path\] and includes all sub-directories.
  2095.               If [drive:] not specified, the Current Drive is used.
  2096.               If [\path\] not specified, the root (\) is used, causing
  2097.               entire drive to be searched.
  2098.               If [fileid] is not specified, the <fileid> field is used.
  2099.  
  2100.               If any files are found, they are appended to the current
  2101.               file list, and the display is positioned to the new files.
  2102.  
  2103.               Toggle current/last display with Ctl-Home keypress.
  2104.  
  2105. Example:
  2106.  ┌───────────────────────────────────────────────────────────────────┐
  2107.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2108.  │  1/3     *.fta                                                    │
  2109.  │FNAAAA   FTA  /ta:                                                 │
  2110.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2111.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2112.  └───────────────────────────────────────────────────────────────────┘
  2113.  
  2114. Causes a search of all directories on the 'a:'  drive for file
  2115. 'FNAAAA.FTA' to be added to the file list.
  2116. %@ign
  2117. %@sec FLAK Command: /V           (Set Video characteristics)
  2118. /V|c|f,b||    Set Video (Normal|Highlited|Intense), fore/background.
  2119.  
  2120.               See 'Startup [options]' for details.
  2121.  
  2122. Example:
  2123.  ┌───────────────────────────────────────────────────────────────────┐
  2124.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2125.  │  1/3     *.fta                                                    │
  2126.  │FNAAAA   FTA      100  06/21/92  10:00  c:\mydir\                  │
  2127.  │FNBBBB   FTB  /vn3,0                                               │
  2128.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2129.  └───────────────────────────────────────────────────────────────────┘
  2130.  
  2131. This sets the 'Normal' fields of the FLAK display to cyan on a black
  2132. background.
  2133. %@ign
  2134. %@sec FLAK Command: /XI          (Exit FLAK)
  2135. /XI           Exit FLAK and return to DOS.
  2136.               Note:
  2137.               The rest of Command Area is ignored, and may contain
  2138.               any characters.
  2139.  
  2140. Example:
  2141.  ┌───────────────────────────────────────────────────────────────────┐
  2142.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2143.  │  1/3     *.fta                                                    │
  2144.  │FNAAAA   FTA  erase                                                │
  2145.  │FNBBBB   FTB  /xise                                                │
  2146.  │FNCCCC   FTC  erase                                                │
  2147.  └───────────────────────────────────────────────────────────────────┘
  2148.  
  2149. Would cause the following command to be issued:
  2150.  
  2151.     ERASE FNAAAA.FTA
  2152.  
  2153. Then, FLAK would stop processing, and return to DOS. The last 'erase'
  2154. command would NOT be issued.
  2155. %@ign
  2156. %@sec FLAK Command: /Y           (Set Substitution Symbol)
  2157. /Y|c|         Specifies the Substitution Symbol to be character 'c'.
  2158.  
  2159.               See 'Startup [options]' for details.
  2160.  
  2161. Example:
  2162.  ┌───────────────────────────────────────────────────────────────────┐
  2163.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2164.  │  1/3     *.fta                                                    │
  2165.  │FNAAAA   FTA  /y>                                                  │
  2166.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2167.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2168.  └───────────────────────────────────────────────────────────────────┘
  2169.  
  2170. Causes the '>' character to become the Substitution Symbol. Thereafter,
  2171. for example, to cause the filename to be included in a DOS command, the
  2172. user would specify:
  2173.  
  2174.      >n
  2175.  
  2176. in the Command Area.
  2177.  
  2178. Remember that previously coded Configuration File 'command-strings' must
  2179. utilize the active Substitution Symbol.
  2180. %@ign
  2181. %@sec Project Files
  2182. FLAK 'Project Files' are disk files containing a [listi] specification
  2183. and/or <fileid>/<path> records.
  2184.  
  2185. Such a file can be read by the '/G@' (Get [listi]) or '/G' (Get)
  2186. commands, to create a file list from the pre-coded information.
  2187.  
  2188. When a Project File is processed by '/G@[fileid]', only the first record
  2189. is read, and it must be a valid [listi] specification.
  2190.  
  2191. When a Project File is read by '/G[fileid]', any record not containing a
  2192. <fileid>/<path> specification is simply ignored.  Each file/path
  2193. specification is checked, and the file listed, if present.  If the file
  2194. is not found, the file statistics fields are replaced with:
  2195.  
  2196.     -- not found --
  2197.  
  2198.  
  2199. Valid Project File record types are:
  2200.  
  2201.     [listi] record
  2202.     <fileid>/<path> records
  2203.  
  2204.  
  2205. The [listi] record is any valid [listi] specification, except '/G' or
  2206. '/G@':
  2207.  
  2208.     [listi]
  2209.  
  2210. where:
  2211.  
  2212.     [listi]
  2213.          Is a [listi] specification, which may be read via the
  2214.          '/G@[fileid]' command.
  2215.          No blanks are allowed.
  2216.          This record is optional, but must be first, if coded.
  2217.  
  2218.  
  2219. The <fileid>/<path> record(s) describe a file and its location,
  2220. which may or may not actually exist:
  2221.  
  2222.     |fileid| |path|
  2223.  
  2224. where:
  2225.     |fileid|
  2226.          Is a file-name/file-extension specification, with the
  2227.          separating period ('.').
  2228.  
  2229.     |pathi|
  2230.          Is the drive/path location of the above file, and is separated
  2231.          from the |fileid| by at least 1 blank.
  2232.  
  2233.  
  2234. Project File records may be created by an editor, or the '/P...'
  2235. FLAK Command, described elsewhere.
  2236.  
  2237. Example:
  2238. A program source file and supporting subroutine file are kept in
  2239. different directories because of their differing roles.  However, during
  2240. development, it is more convenient to have both files 'visible' and
  2241. easily accessible at the same time. So, assume the following file, named
  2242. 'MYPROJ.FLK':
  2243.  
  2244.     mypgmain.c  c:\source
  2245.     mypgmsub.c  c:\suptlib
  2246.  
  2247.  
  2248. Then,
  2249.  ┌───────────────────────────────────────────────────────────────────┐
  2250.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2251.  │  1/3     *.fta                                                    │
  2252.  │FNAAAA   FTA  /gmyproj.flk                                         │
  2253.  │FNBBBB   FTB      200  06/22/92  11:00  c:\mydir\                  │
  2254.  │FNCCCC   FTC      300  06/23/92  12:00  c:\mydir\                  │
  2255.  └───────────────────────────────────────────────────────────────────┘
  2256.  
  2257. would produce the following:
  2258.  ┌───────────────────────────────────────────────────────────────────┐
  2259.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2260.  │  1/2     /gmyproj.flk                                             │
  2261.  │MYPGMAIN C        100  06/21/92  10:00  c:\source\                 │
  2262.  │MYPGMSUB C        200  06/22/92  11:00  c:\suptlib\                │
  2263.  └───────────────────────────────────────────────────────────────────┘
  2264. %@ign
  2265. %@sec Resource Utilization & Optimization
  2266. At startup, FLAK Version 1.01 requires approximately 170KB RAM,
  2267. providing a minimum file list of 200 fileids.  More RAM is obtained as
  2268. the file list gets larger.
  2269.  
  2270. When FLAK runs an executable, it allocates whatever RAM is still
  2271. available in the system.
  2272.  
  2273. When the executable completes, the RAM is deallocated.  Therefore,
  2274. DO NOT execute TSR's (Terminate and Stay Resident programs) from FLAK.
  2275.  
  2276. Swapping:
  2277. ─────────
  2278. If more memory is needed for a particular executable -- you may see
  2279. either of the following error messages:
  2280.  
  2281.     Cannot execute [pathi][fileid]
  2282. or,
  2283.     Out of memory
  2284.  
  2285. specify the '[S' (maximum Storage required) Flag in the Command Area (or
  2286. 'command-string' in a Configuration File definition).  FLAK will 'swap'
  2287. (write) itself out of RAM into a temporary disk file during the
  2288. specified executable, and then read itself back into RAM afterwards.
  2289.  
  2290. This will make all but approximately 3KB of RAM available for the
  2291. executable, but will also add the processing necessary to perform the
  2292. swap operation.
  2293.  
  2294. If maximum storage is required for ALL executables, issue the '/SY'
  2295. command, or code it on a Configuration File parameter record.
  2296.  
  2297. Swap File Allocation:
  2298. ─────────────────────
  2299. When FLAK starts, it allocates the temporary swap disk file according to
  2300. the path definition found in the following environment variables, in the
  2301. order shown:
  2302.  
  2303.     FLAKTMP
  2304.     TEMP
  2305.     TMP
  2306.  
  2307. If none of the above have been specified, the swap file is allocated in
  2308. the Current Directory.
  2309.  
  2310. Therefore, if you want to allocate the swap file to a particular device
  2311. or area (a RAM disk is the best candidate), issue the following DOS
  2312. command, prior to FLAK startup:
  2313.  
  2314.     set flakmp=d:\path\
  2315.  
  2316. Where:
  2317.  
  2318.     d:\path\
  2319.          Is a drive and path designation, which MUST EXIST.
  2320.  
  2321.  
  2322. Swap Fileid:
  2323. ────────────
  2324. The swap fileid is 'FLAKnnnn.TMP', where 'nnnn' is automatically
  2325. replaced with a unique sequential identifier.
  2326. %@ign
  2327. %@sec Network Execution
  2328. Each invocation of FLAK creates a unique swap file, and thus is
  2329. compatible with multi-user network execution.
  2330.  
  2331. However, FLAK takes no other action for network execution:  The
  2332. appropriate networking environment must be setup for any executables run
  2333. ('SHARE.EXE' CONFIG.SYS entry, for example).
  2334. %@ign
  2335. %@sec Windows Installation
  2336. FLAK may be installed under Microsoft WINDOWS as follows:
  2337.  
  2338.   1. Start Windows.
  2339.   2. Select icon for Program Manager.
  2340.   3. Select icon for the Program Group in which you want FLAK to appear.
  2341.   4. Select File.
  2342.   5. Select New...
  2343.   6. Select Program Item * OK.
  2344.   7. Enter in the Description field:  FLAK
  2345.   8. Enter in the Command Line field: [pathi]flak.exe [parms]
  2346.      where:
  2347.          [pathi]
  2348.               Is the path describing where FLAK.EXE is located.
  2349.          [parms]
  2350.               Are any desired FLAK command-line parameters.
  2351.               Alternatively, you may leave out the [parms], and enter
  2352.               any desired options in the FLAK.CFG Configuration File.
  2353.  
  2354.   9.  Select OK.
  2355.  
  2356. Now, to run FLAK, just select the "FLAK" icon.
  2357. %@ign
  2358. %@sec Hints
  2359. Hint:
  2360. ─────
  2361. A convenient working environment for typical compiling/debugging is the
  2362. combination of files ordered by date ('/OD') which places most-recently
  2363. created/modified fileids at the top of the list, and a function-key
  2364. definition which rebuilds the file list from the Current Directory
  2365. ('/CL=').
  2366.  
  2367. By simply hitting the function-key, the files most likely to require
  2368. attention (modified source file, compiler error listing, etc) will
  2369. remain in view, at the top of the screen.
  2370.  
  2371.  
  2372. Hint:
  2373. ─────
  2374. By combining command repetition and symbolic substitution, the user is
  2375. afforded a powerful capability to handle groups of files:
  2376.  
  2377.  ┌───────────────────────────────────────────────────────────────────┐
  2378.  │flak 1.01 c:\mydir\                             Mon 01/02/92, 13:45│
  2379.  │  1/3     *.fta                                                    │
  2380.  │FNAAAA   FTA  ren [ [n.old                                         │
  2381.  │FNBBBB   FTB  =                                                    │
  2382.  │FNCCCC   FTC  =<ENTER>                                             │
  2383.  └───────────────────────────────────────────────────────────────────┘
  2384.  
  2385. Results in the following commands:
  2386.  
  2387.     RENAME  FNAAAA.FTA  FNAAAA.OLD
  2388.     RENAME  FNBBBB.FTB  FNBBBB.OLD
  2389.     RENAME  FNCCCC.FTC  FNCCCC.OLD
  2390.  
  2391.  
  2392. Hint:
  2393. ─────
  2394. A Configuration File can be designed for Application Launching by
  2395. combining the '/G' command naming a Project File of applications, and
  2396. the '/EY' command allowing 1-blank Command Area executions.  For
  2397. instance, assume the Configuration File 'MYAPPLS.CFG', as follows:
  2398.  
  2399.     /gmyappls.lst /ey /sy
  2400.  
  2401. And assume the 'MYAPPLS.LST' Project File:
  2402.  
  2403.     editor.exe    c:\prdctn\
  2404.     wordproc.exe  c:\prdctn\
  2405.     sprdshet.exe  c:\prdctn\
  2406.     calcultr.com  c:\testlib\
  2407.  
  2408. Then, the command:
  2409.  
  2410.     flak /cmyappls.cfg
  2411.  
  2412. would present the above fileids, and enable execution via a single blank
  2413. followed by <ENTER>.
  2414.  
  2415. Similarly, you may assign the '/Gmyappls.lst' command to a Function Key,
  2416. to 'pop-up' a list of applications during a FLAK session.
  2417.  
  2418. You would probably have issued the '/SY' and possibly the '/EY' commands
  2419. beforehand, to ensure maximum RAM for the applications, and single-blank
  2420. execution capability.
  2421. %@ign
  2422. %@sec Version History
  2423. FLAK  Version 1.00  08/04/92
  2424. ────────────────────────────
  2425. This version is the initial public offering of the program.
  2426.  
  2427. FLAK  Version 1.01  10/04/92
  2428. ────────────────────────────
  2429. Modification to the system call routine provides access to the primary
  2430. environment area variables, allowing executables to successfully access,
  2431. modify, and delete environment variables.
  2432. %@ign
  2433. %@sec HELP Utilization
  2434. %@ign (This section is for HELP <F2> processing and must be LAST)
  2435. HELP allows reading a file with a Table Of Contents (TOC).  By high-
  2436. lighting a particular TOC entry with the Up/Down Arrow keys and pressing
  2437. the <ENTER> key, that section is displayed.  HELP also uses the
  2438. following keys, as indicated:
  2439.  
  2440.                   Key Action, while displaying...
  2441.                   ─────────────────────────────────────────────────────
  2442. Key               ..Table of Contents (TOC)     ..Selected Section
  2443. ───────────       ─────────────────────────     ───────────────────────
  2444. F1                Display this HELP             Display this HELP
  2445. Esc               Exit HELP                     Return to TOC
  2446. Down  Arrow       Next TOC entry                Next screen/section
  2447. Tab   Forward     Next TOC entry                Next screen/section
  2448. Page  Down        Next TOC screenful            Next screen/section
  2449. Enter             Display highlited section     Next screen/section
  2450. Space             Display highlited section     Next screen/section
  2451. Up    Arrow       Previous TOC entry            Previous screen
  2452. Tab   Backward    Previous TOC entry            Previous screen
  2453. Page  Up          Previous TOC screenful        Previous screen
  2454. Home              Top of screen                 Top of section
  2455. End               Bottom of screen              ...
  2456. Right Arrow       Next     TOC entry            Next     section
  2457. Left  Arrow       Previous TOC entry            Previous section
  2458. b                 Toggle Bell ON/OFF            Toggle Bell ON/OFF
  2459.  
  2460. Whenever the displayed Section changes, the bell is sounded (if ON).
  2461. %@ign     <<<<<=====-----.... end-of-file ....-----=====>>>>>
  2462.